home *** CD-ROM | disk | FTP | other *** search
/ AGA Toolkit '97 / The AGA Toolkit '97.iso / c / dimp.man < prev    next >
Text File  |  1996-09-07  |  5KB  |  112 lines
  1.  
  2.     Disk Imploder V2.27 by A.J.Brouwer.  FreeWare
  3.     ---------------------------------------------
  4.  
  5.  
  6. NAME
  7.     DImp - Archives cylinders.
  8.  
  9.  
  10. SYNOPSIS
  11.     DImp READ <SourceDrive> Ca[-Cb,Cc,..] <TargetFile> [-M?|-NB|-NC|-X] [+Readme]
  12.       The collection of cylinders to be read must be specified by ranges, Ca-Cb,
  13.       and/or single cylinders, separated by commas.
  14.       -M? or MODE?    = Compression mode, ? = 0-7, default = 5
  15.       -NB or NOBITMAP = Ignore bitmap (normally unused blocks are cleared)
  16.       -NC or NOCOMP   = Do not compress cylinders
  17.       -X  or EXE      = Create self-extracting overlayed executable
  18.       +"Name of Readme file to be displayed during WRITE"
  19.     DImp WRITE <DImpFile> <TargetDrive>
  20.     DImp INFO <DImpFile>
  21.     DImp ABOUT
  22.     DImp will use ".dmp" or ".dex" filename extensions when trying to
  23.     create or recognize DImp data files.
  24.  
  25.  
  26. DESCRIPTION
  27.       DImp allows you to compress a subselection of cylinders from
  28.     any floppy compatible device into a file.  DImp is fast and
  29.     sports a good compression ratio.  Notably, DImp allows you to
  30.     create a self extracting file with an appended readme text,
  31.     thus providing you with a completely self-contained method of
  32.     distributing a disk's contents in a file.
  33.  
  34.        There are four operation mode keywords; "READ" specifies
  35.     that cylinders must be read, "WRITE" indicates that you wish to
  36.     write cylinders encoded in a dimped file, "INFO" displays
  37.     information about the contents of a file containing dimped
  38.     cylinders, and "ABOUT" should be obvious.
  39.  
  40.       The cylinders are individually compressed, checksummed and
  41.     stored, thus, in case of a transmission error, valid cylinders
  42.     can be undimped, and the originator can then select, dimp and
  43.     retransmit the faulty cylinders.
  44.  
  45.       The cylinders to be READ can be selected by entering cylinder
  46.     numbers separated by commas, or a dash if you wish to specify
  47.     a range of cylinders.
  48.  
  49.       When reading or writing, DImp can handle any device that
  50.     supports the normal floppy 2 heads 11 sectors etc. layout,
  51.     thus it is usable with f.e a RAD: or an FMS disk.  You can omit
  52.     the colon normally following these device names.
  53.  
  54.       Additional options include compression mode selection override.
  55.     Given the fact that the tracks are compressed individually, the
  56.     default mode 5 has a pretty optimal compression ratio, though
  57.     the ratio isn't as good as it might have been if cylinder data
  58.     had been treated as a continuous stream.  This is a design choice
  59.     intended to allow the aforementioned flexible handling of
  60.     individual cylinders.
  61.  
  62.       If there's sufficient free memory, DImp will allocate buffers
  63.     for a turbo compression algorithm.  Also, reducing the crunch
  64.     mode will speed things up, dramatically so if you don't have
  65.     sufficient free memory for DImp to run in turbo mode.  Lowering
  66.     the crunch modes results in less efficient compression though.
  67.  
  68.       Next, there are a couple of option switches.  NOBITMAP
  69.     prevents DImp from discarding data that, according to the disk's
  70.     bitmap, isn't used by the filing system.  This option is rarely
  71.     needed.  If you suspect a disk to contain a program that uses a
  72.     low level routine to read its information from that disk, this
  73.     option might be required to prevent loss of relevant data.
  74.     NOCOMP disables compression.  EXE causes DImp to generate self
  75.     extracting dimp files.  These can be executed, and will write
  76.     their contents to a disk selected by the user.  Executable DImp
  77.     files (.dex filename extension) can be treated as normal DImp
  78.     files (.dmp filename extension) in that you can use DImp to
  79.     WRITE these, or get INFO on them.
  80.  
  81.       Lastly, you may specify a filename containing text to be
  82.     displayed during the writing or self-extraction of the dimp file
  83.     you're creating.  This allows you to include a fairly extensive
  84.     comment on the contents of the disk.  This readme filename must
  85.     follow a "+" commandline indicator.
  86.  
  87.  
  88. EXAMPLES
  89.     DImp READ rad 0-79 Work:Cylinders EXE +ram:blahblah
  90.  
  91.  
  92. TECHNOCRAP
  93.       The self-extracting executable files generated by DImp are
  94.     overlayed.  This allows for the cylinder data to be spooled
  95.     during the self-extraction process, resulting in much more
  96.     modest memory requirements than the size of the executable
  97.     would lead one to suspect.
  98.  
  99.       Thanks to resource tracking, transparent error management,
  100.     modular algorithm linking, and sitting on the program for
  101.     several years before releasing it, DImp should be very robust
  102.     and return sensible error messages.
  103.  
  104.     DImp is pure and can be made resident.
  105.  
  106.  
  107. AUTHOR
  108.     Albert-Jan Brouwer 
  109.     UUCP hp4nl.nluug.nl!cbmnlux!ecl001!ajbrouw
  110.     UUCP cbmvax.commodore.com!cbmehq!cbmnlux!ecl001!ajbrouw
  111.     FIDO: 2:281/614 (up for freq sometime fall '91)
  112.